StructFindValue(Top, Key [, Scope])

StructFindValue was added in ColdFusion 4.5.1, SP2. StructFindValue searches recursively through an arbitrarily complex sub-structure of nested arrays, structures, and other elements and returns an array containing any structures with values that match the key specified in the Key parameter.

Top

The ColdFusion object (either a structure or an array) from which to start the recursive search. It is the object not the name of the object.

Key

The type of the value must be a simple object. If no matches are found, an array is still returned, but its size will be 0.

Scope

The optional Scope attribute specifies whether one or all of the matching keys should be returned. Valid entries for the Scope parameter are "ONE" and "ALL" (default is "ONE.")